home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / programs / tb044.zip / TURBOARD.DOC < prev    next >
Text File  |  1992-05-29  |  66KB  |  1,620 lines

  1. TurBoard v0.40
  2.  
  3. from Software @ Work
  4.  
  5. TurBoard Version 0.40 Sysop's Reference Manual
  6. (c) Copyright Shawn Rhoads 1991,92, All Rights Reserved
  7. (c) Copyright Software @ Work 1991,92, All Rights Reserved
  8.  
  9. May 28, 1992
  10.  
  11. This document written by Shawn Rhoads
  12.  
  13. TurBoard is an NAPLPS, ANSI and ASCII asynchronous
  14. telecommunications program designed to provide server E-Mail,
  15. data and information exchange for a group of users.  The system
  16. can be used in a public or private environment and over a LAN or
  17. Modem connection.
  18.  
  19. If you wish more information about TurBoard and how to register
  20. your copy for $35, contact:
  21.  
  22. Shawn Rhoads
  23. Software @ Work
  24. P.O. Box 283
  25. Chattanooga, TN 37401-283
  26. (615) 756-8220 (voice)
  27. (615) 756-7810 (data)
  28.  
  29. Unfortunately, time has not yet been taken to write a detailed
  30. specification of the TurBoard BBS System.  This document has
  31. been written to enlighten TurBoard Sysops of the commands they
  32. can use to configure their system.
  33.  
  34. You can always leave a message on the support bulletin board in
  35. the TURBOARD forum.
  36.  
  37. TurBoard v0.40 Sysop's Reference Manual
  38.  
  39. Table of Contents:
  40.  
  41. 1. Requirements  . . . . . . . . . . . . . . . . Page 3
  42. 2. Installation Instructions   . . . . . . . . . Page 3
  43. 3. Configuration   . . . . . . . . . . . . . . . Page 4
  44.        Changing System Options . . . . . . . . . Page 4
  45.        Customizing Security Levels . . . . . . . Page 5
  46.        Forum and File Security . . . . . . . . . Page 6
  47.        Ads, BBS List, Books  . . . . . . . . . . Page 7
  48.        Doors and Misc Security Menu  . . . . . . Page 7
  49.        FidoNet Security Menu . . . . . . . . . . Page 8
  50. 4. Adding and Maintaining Bulletins  . . . . . . Page 9
  51. 5. Mail Forums . . . . . . . . . . . . . . . . . Page 9
  52.        Maintaining Mail Forums . . . . . . . . . Page 10
  53.        Chairmanship  . . . . . . . . . . . . . . Page 10
  54.        Security in Mail Forums . . . . . . . . . Page 11
  55. 6. File Directories  . . . . . . . . . . . . . . Page 12
  56.        Adding and Maintaining File Directories . Page 12
  57.        Adding Files to Your Directories  . . . . Page 13
  58.        UPLOADS and how they work . . . . . . . . Page 13
  59. 7. Doors . . . . . . . . . . . . . . . . . . . . Page 14
  60. 8. The YAK Subsystem . . . . . . . . . . . . . . Page 15
  61. 9. User Commands . . . . . . . . . . . . . . . . Page 16
  62. 10. Classified . . . . . . . . . . . . . . . . . Page 17
  63. 11. BBS List . . . . . . . . . . . . . . . . . . Page 18
  64. 12. On-Line Books  . . . . . . . . . . . . . . . Page 19
  65. 13. Art Gallery  . . . . . . . . . . . . . . . . Page 19
  66. 14. Keyboard Commands  . . . . . . . . . . . . . Page 19
  67. 15. Colors?  . . . . . . . . . . . . . . . . . . Page 20
  68. 16. Full Screen Editor . . . . . . . . . . . . . Page 21
  69. 17. Line Editor  . . . . . . . . . . . . . . . . Page 21
  70. 18. Command Line Parameters  . . . . . . . . . . Page 21
  71. 19. Modem Configuration  . . . . . . . . . . . . Page 23
  72. 20. FidoNet! . . . . . . . . . . . . . . . . . . Page 23
  73.        Configuration of TurBoard with FidoNet  . Page 24
  74.        Setting up FidoNet for the First Time . . Page 24
  75.        TBFIDO.EXE  . . . . . . . . . . . . . . . Page 24
  76.        COST and TurBoard . . . . . . . . . . . . Page 25
  77.        EchoMail  . . . . . . . . . . . . . . . . Page 25
  78. 21. Customizing Your Displayed Screens . . . . . Page 26
  79. 22. NAPLPS Graphics  . . . . . . . . . . . . . . Page 28
  80. 23. DAILY.BAT (Daily Batch event)  . . . . . . . Page 28
  81. 24. TurBoard Terminal Emulation  . . . . . . . . Page 28
  82. 25. Registered TurBoard Sysops   . . . . . . . . Page 29
  83.  
  84. TurBoard represents a *lot* of work.  Even if you don't
  85. contribute to the shareware cause, we are always looking for new
  86. ideas!  Please support the shareware cause with your input, call
  87. the support BBS (PC Chattanooga, 615/756-7810) and give us your
  88. input!
  89.  
  90. Requirements
  91.  
  92. TurBoard requires that you have a PC-DOS session with at least
  93. 320 kilobytes of RAM. A serial port, modem and LAN hardware are
  94. optional.  While the serial port and modem are not required to
  95. run this program in local mode, you must have them to run a
  96. bulletin board system!
  97.  
  98. It is suggested that you use a asynchronous communications
  99. FOSSIL and have DSZ loaded into your PATH.  Other than this, no
  100. other software is required.
  101.  
  102. If you intend to run a message intensive system, a 2400 baud
  103. modem and about 5 MB of free hard disk space is all that is
  104. required to run a small to modest message based system.  If you
  105. want to add doors, download files, FidoNet echo forums and other
  106. features generally associated with bulletin board systems, it is
  107. suggested that you have a 20 MB hard disk minimum.  There is no
  108. upper limit.
  109.  
  110. For local NAPLPS displays, TurBoard requires that you have a EGA
  111. or a VGA installed in your computer.  CGA mode can be used with
  112. a device driver from PC Chattanooga, but it is not recommended,
  113. and the poor graphics make it almost unusable.  This, however,
  114. will not hinder your callers from using NAPLPS, you will mearly
  115. see the NAPLPS codes locally in text mode rather than seeing the
  116. NAPLPS images.  (For optimum speed, it is suggested that you
  117. keep local viewing off via the Alt-S)noop command anyway.)
  118.  
  119. Installation Instructions
  120.  
  121. Ensure you have a copy of DSZ (file transfer program) and it is
  122. included in your current path, TurBoard requires this.  Also,
  123. you should have a FOSSIL loaded, I suggest using X00.SYS.  You
  124. can install X00.SYS in your CONFIG.SYS with the statement
  125. DEVICE=X00.SYS.
  126.  
  127. UnZip the file TB???.ZIP in the directory you wish TurBoard to
  128. reside.
  129.  
  130. ! Save a copy of TB???.ZIP, as some of the files will be removed
  131. (the ZIP's) after they are used by the INSTALL program.
  132.  
  133. 1) To configure your TurBoard system for the first time, simply
  134. type:
  135.  
  136.   INSTALL
  137.  
  138. The correct subdirectories will be created and zip files will be
  139. unzipped (make sure that your PKUNZIP program is in the current
  140. path).
  141.  
  142. 2) Once the INSTALL program has successfully run, you will be
  143. prompted to start TurBoard by entering the following command:
  144.  
  145.   TB
  146.  
  147. 3) If this is the first time you have dealt with TurBoard,
  148. choose the Q)icksetup option.  TurBoard will create all the
  149. subdirectories it needs and you will only be prompted for
  150. hardware specific information.
  151.  
  152. When configuring your modem, you should see a configuration
  153. option similar to your modem.  If not you may use the modem
  154. configuration strings included in a later chapter to help you
  155. configure your particular modem.
  156.  
  157. Always use TB.BAT!  This is how you should always start the
  158. TurBoard BBS system.  If you do not, the system will stop
  159. whenever someone enters a door or downloads a file.
  160.  
  161. Answer the questions.  If you have a problem configuring your
  162. modem, (you do not get the "Waiting . . ." status after you have
  163. configured everything,) we may need to set up a special modem
  164. definition for your specific modem.  If this is the case, call
  165. the TurBoard Support BBS system (PC Chattanooga) at 615/756-7810.
  166.  
  167. The following two files will be unzipped in the TEXT and YAK
  168. subdirectories of the same name.  They will be deleted when
  169. INSTALL runs, but you may want to install them yourself.  They
  170. are described here for your information.
  171.  
  172. TEXT.ZIP  - Includes Help Files, Welcome, and Logoff Screens.
  173. YAK.ZIP   - Includes the menu files, news files, and the yak
  174. data files.
  175.               (more on this later)
  176.  
  177. After this you may delete these ZIPs, you will no longer need
  178. them all the other files are created automatically as they are
  179. needed.
  180.  
  181. Configuration
  182.  
  183. Once you are at the call waiting screen, you will probably want
  184. to customize your system to reflect the BBS name, open or
  185. closed, etc.
  186.  
  187. To log on for the first time, type Alt-L for local login.  Give
  188. the name and password you specified when you installed TurBoard.
  189.  When you see the ">" symbol, this is the primary TurBoard
  190. command prompt.  Any command may be entered whenever you see
  191. this prompt.
  192.  
  193. Enter the "SE" (for setup) command and choose option 1.  Now you
  194. may change your system name and some other parameters.  To
  195. change how your system displays news and other options, you may
  196. wish to read "The YAK Subsystem" section below.
  197.  
  198. You will see a menu containing options to customize system
  199. information, security levels, forum and file security, ads, BBS
  200. list and book options, doors and misc. options, FidoNet options
  201. and security and modem settings.
  202.  
  203. Following are some guidelines for configuring these options.
  204.  
  205. Changing System Options
  206.  
  207. You are already familiar with the SE command.  Option 1 allows
  208. you to change some of the primary system settings.  They are
  209. explained below:
  210.  
  211. Name - This is the system name (ex: PC Chattanooga) that you
  212. wish to refer to you BBS system as.  Setting this option will
  213. cause your system name to appear throughout the system menus,
  214. such as the file directory screens.
  215.  
  216. Password - If you desire, you may require a logon password for
  217. EVERYONE to use every time they log on.  Some Sysops desire a
  218. private board, but one you don't have to be pre-registered to
  219. log into, this is a method to accomplish that.
  220.  
  221. Sysop Password - For added Sysop access security, this option
  222. will require all users with Sysop access to enter this password.
  223.  This is good if your Sysops use their password on another
  224. system.
  225.  
  226. Sysop Avail - Toggles the message the user gets when O option is
  227. used.  Same as Alt-O at the keyboard, but allows the Sysop to
  228. turn this option on and off remotely.
  229.  
  230. Sound - If this option is turned on, the BBS will beep (ASCII 7)
  231. when the user does.  This is defaulted to off.
  232.  
  233. Zone - Used to specify the primary FidoNet zone of the BBS.
  234. Normally 0 for a non-FidoNet system.
  235.  
  236. Net - Used to specify the primary FidoNet network of the BBS. 
  237. Normally 0 for a non-FidoNet system.
  238.  
  239. Node - Used to specify the primary FidoNet node of the BBS. 
  240. Normally 0 for a non-FidoNet system.
  241.  
  242. Point - Used to specify the primary FidoNet point of the BBS. 
  243. Set this option to 0 for a non-FidoNet, or a primary node system.
  244.  
  245. Total Callers - How many people have called the BBS to date.
  246.  
  247. Open System - Normally yes, this option can disallow new users
  248. tolog on.
  249.  
  250. Time Zone - Specifies which time zone the BBS resides.
  251.  
  252. Log Records - Specifies how the system log is kept.  If None,
  253. then no monthly files are kept of the user activity.  Set this
  254. option to 1 for monthly files.
  255.  
  256. Customizing Security Levels
  257.  
  258. The TurBoard security levels can be customized by choosing
  259. option 2 from the SE command.  You can add new security
  260. definitions as well as change names and time limits on currently
  261. defined levels.  You can enter colors at the command input line,
  262. but you will need some additional information, refer to the
  263. "Colors?" section below.
  264.  
  265. Forum and File Security
  266.  
  267. These are security levels generally associated with options for
  268. message forums and file directories.  The are modifiable so that
  269. certain privileges may be given and removed from different
  270. security classes.
  271.  
  272. Add Forum - This security and higher has the authority to add a
  273. new message forum.  He may not, however automatically be able to
  274. use the CH command on that forum!
  275.  
  276. Edit Forum options (CH command) - This security and higher has
  277. the authority to issue the CH command in any message forum,
  278. regardless if he is the actual forum chairman or not.
  279.  
  280. Delete Forum - This security and higher has the authority to
  281. remove any message forum with the DF command.  (The actual data
  282. files must still be manually deleted.)
  283.  
  284. Enter FidoMail - This security and higher may enter FidoNet
  285. messages in a (the) message forum designated as FidoNet. 
  286. Persons with security levels below this specified level may only
  287. enter "normal" messages into the forum.  (Which do not get
  288. routed into FidoNet.)
  289.  
  290. Read all mail - Probably should be named "read private mail". 
  291. This person may read ANYTHING, including all message forums and
  292. all private mail in those message forums.
  293.  
  294. Move Message - Security required to issue the MM command which
  295. moves a message from the current forum to another forum.
  296.  
  297. Add File Directory - Security required to add a new file
  298. directory.  (colors may be used as in naming of security levels.
  299.  
  300. Delete Directory - Security required to remove an <empty> file
  301. directory.
  302.  
  303. FF (or Find Files) - This command will search all your
  304. directories and add any new files in those directories.
  305.  
  306. Edit Directory Entry - This is the security required to edit a
  307. FILE ENTRY, not a directory entry (which may not be edited once
  308. created.)
  309.  
  310. Edit Extended - Allows access to extended file entry functions
  311. including resetting the review of the file as well as editing
  312. the comments file.
  313.  
  314. Ads, BBS List, Books Security
  315.  
  316. This menu (option 4 in the setup section) deals with securities
  317. for the classified ads, BBS list and Books subsystem.  For
  318. additional information on each of these, please refer to the
  319. appropriate section.
  320.  
  321. Delete Ad - This security and higher has the authority to read
  322. and delete ANY classified ad.
  323.  
  324. Ad categories - This security and higher has the authority to
  325. alter the characteristics of any ad category.  This includes
  326. security levels, etc.  (see the section on classified ads.)
  327.  
  328. Delete BBS entry - Authority to delete BBS entry.  The only time
  329. a user may delete an entry but not have the required security
  330. level is if they were the one who entered it in the first place.
  331.  In case you want the users to have Delete access all the time,
  332. lower this option to the security you prefer.
  333.  
  334. BBS Sysop Info - Shows detailed information about Sysop's home
  335. address, etc.
  336.  
  337. Make BBS text - Security required to created the actual BBS text
  338. file that you may or may not want to issue every month.
  339.  
  340. Add BOOK - Required security to add a new book.  (see section on
  341. books for more details)
  342.  
  343. Edit Chapter - Required security (if you are not the "author" of
  344. a book) to edit a chapter in the book.
  345.  
  346. Add chapter - Required security (if you are not the "author" of
  347. a book) to add a chapter to the book.
  348.  
  349. Add bulletin - Required security to issue the AB command which
  350. creates a new bulletin.
  351.  
  352. Delete bulletin - Required security to issue the DB command
  353. which removes a current bulletin.
  354.  
  355. Edit Bulletin - Required security to issue the EB command which
  356. edits a current bulletin.
  357.  
  358. Enter Resume - Required security to enter a resume into the
  359. classified ads system.
  360.  
  361. Scan Resume - Required security to scan resume's in the
  362. classified ads system.
  363.  
  364. Doors & Misc Security Menu
  365.  
  366. This section (option five in the setup menu) deals with security
  367. levels for on-line doors and other special command line options
  368. including the YAK subsystem, which controls things such as the
  369. on-line news and the main menu.  You can customized the system
  370. to your preference, and this menu sets up the security levels to
  371. do so.
  372.  
  373. Add Door - This is the security required to issue the AD command
  374. to set up a new external door.
  375.  
  376. Edit Door - This is the security required to issue the ED
  377. command used to change the options of a door's setup.
  378.  
  379. Edit Text Files - This is the security required to issue the
  380. EDIT command at the > prompt.  The EDIT command requires that
  381. you include a parameter on the line indicating the path and
  382. filename of the file you wish to edit.  (For file names with no
  383. extension, be sure and include a period at the end.  Ex: > edit
  384. shawn.  )
  385.  
  386. Type Text Files - Security required to issue the TYPE command at
  387. the > prompt.  This is useful in displaying a file you just
  388. edited witht he EDIT command.  A file name parameter is required
  389. here also as well as the same period naming convention (see
  390. above).
  391.  
  392. Detailed Log - This is the security required to see a log
  393. including anything other than the (1) logon action.  For more
  394. information see the Log section of the manual.
  395.  
  396. Edit Users - This is the security required to edit any user
  397. other than yourself, (and to edit some normally uneditable
  398. options on your record.)  Normally reserved for Sysops only. 
  399. Also, all passwords will be visible by this security level.
  400.  
  401. Yak Subsystem - This is the required security to initiate the
  402. YAK subsystem editor.  (YAK is the command.)
  403.  
  404. Setup Menus - This is the security to start these setup menus.
  405.  
  406. Upload SL - This is the security level required to upload files
  407. (use the U command).
  408.  
  409. New User SL - This is the security level assigned to first time
  410. callers.
  411.  
  412. FidoNet Security Menu
  413.  
  414. This menu contains some configuration options for FidoNet.  Some
  415. ofthem are for debugging problems that may exist in FidoNet,
  416. others are just for looks.
  417.  
  418. Set NetMail Ctrl - This is a debugging tool used to see the
  419. operation of the SEEN-BY, ^aPATH and other lines, in case there
  420. is a routing problem with one of your FidoNet Echos.  (This
  421. options will cause problems if you are sending mail down the
  422. line to another system, please use with caution!)
  423.  
  424. EchoMail origin - This is that famous " * Origin: " line that
  425. everyone is so cute with.  You may enter anything here, but
  426. preferably your system name and location.  "(net/node)" will be
  427. automatically appended on the end.
  428.  
  429. Point Network - If you have a point network, specify it here so
  430. that mail will be properly routed to your points.
  431.  
  432. Allow Passthrough - Probably should be named, "allow leech". 
  433. Tells TurBoard to take mail that was not addressed to you, but
  434. to someone else, and send it.  (This may or may not be a long
  435. distance call.)  This is only for NetMail, not EchoMail.
  436.  
  437. Adding and Maintaining Bulletins
  438.  
  439. It's a good idea to put important information for your users in
  440. bulletins so they can refer back to the information as often as
  441. they need to.  Bulletins are controlled solely in the TurBoard
  442. environment.  You never need to go outside the system unless you
  443. wish to import data or text from another source.
  444.  
  445. Initially, TurBoard has no bulletins.  If you wish to create
  446. one, you will need to use the AB command.  Once you issue the AB
  447. command, you will be prompted for the description of the
  448. Bulletin.  This is the text that will appear in the main
  449. bulletin menu.
  450.  
  451. Once you've entered the description, you will enter the editor
  452. (either full screen or line, depending on your setup).  Here is
  453. where you will enter the actual bulletin text.  If you are in
  454. the full screen editor, you can enter colors with the Ctrl-W
  455. command.
  456.  
  457. After the bulletin is saved, you will be prompted for the
  458. security level of persons with access to the bulletin, as well
  459. as a read flag.  This flag displays "No" or "Yes" depending if
  460. the person has read the bulletin or not.  (It does require some
  461. file space, but only 1 bit per person, very small.)
  462.  
  463. For example, lets create a new bulletin via the AB command
  464. entered at the TurBoard prompt:
  465.  
  466. > AB <enter>
  467.  
  468. You will notice that you are now creating a new bulletin.
  469.  
  470. Some there are some special files you can place in your bulletin
  471. directory to add NAPLPS support that will override the normal
  472. TurBoard displays.  Using this technique, you can create a
  473. customized bulletin display that will take full advantage of
  474. NAPLPS.
  475.  
  476. If you wish to create your own bulletin menu in place of the
  477. normal TurBoard created menu, create a file called BULLN (for
  478. NAPLPS), BULLG (for ANSI) or (BULL) for ASCII and place it in
  479. the DOS directory named TEXT (under the TurBoard root
  480. directory).  It is the System Operators responsibility that the
  481. BULL? file matches the information that TurBoard knows.
  482.  
  483. In addition, you can create specific emulation files for NAPLPS,
  484. ANSI and ASCII.  The name of the file is BUL[bulletin
  485. number][Emulation code] with no extension.  For example, if you
  486. wanted to add a NAPLPS frame for bulletin number 3, the name of
  487. the file would be BUL
  488.  
  489. Mail Forums
  490.  
  491. The basis for any bulletin board or other telecommunication
  492. program is the ability for users to communicate with one
  493. another.  I've attempted to make TurBoard as communications
  494. intensive as I could.  While some packages refer to message
  495. forums as "bases," "areas" or "conferences."  I choose "forum"
  496. because that is what messaging should be:  a forum for
  497. discussion!
  498.  
  499. In any case, TurBoard allows unlimited message forums
  500. (limited,rather, by your available hard disk space).  I choose
  501. names rather than numbers to give a more human feel to each
  502. forum (and if a BBS has 200 forums, who knows what #132 is?)  I
  503. am, however, considering switching to a number format if there
  504. are enough requests.
  505.  
  506. Create the message forums with the AF command (standing for Add
  507. Forum).  The first forum you create is very important!  It is
  508. the all time default forum.  I choose to call mine "PRIMARY". 
  509. Unless another forum is joined first or someone reads all the
  510. messages and automatically joins the next forum, messages
  511. entered with the E command get sent to this forum.
  512.  
  513. The primary message forum will always be displayed at the top of
  514. the forum list.  Everything below that is sorted in alphabetical
  515. order.
  516.  
  517. These are the TurBoard message commands that are active when you
  518. are reading mail.  These commands are meaningless unless the P,
  519. R or S command is active.
  520.  
  521. Maintaining Mail Forums
  522.  
  523. Usually, there are no requirements placed upon the Sysop for
  524. maintaining the message forums.  And assuming you had unlimited
  525. disk space, everything would be okay.
  526.  
  527. But, for networking reasons, when messages are deleted, they are
  528. NOT removed.  They are  flagged for deletion until some process
  529. (currently the sysop only, but events are planned) comes along
  530. and physically removes them.
  531.  
  532. The PM (for pack messages) is a local forum command that removes
  533. all messages flagged for deletion as well as all private mail
  534. that has been read.
  535.  
  536. Another problem that Sysops run into is messages entered into a
  537. forum that really belong somewhere else (like in the primary
  538. forum).  The MM (for move message) command will copy a message
  539. to the specified forum and flag the original message for
  540. deletion.
  541.  
  542. Conference Chairmen have the ability to PM and MM in their
  543. respective forum (and only in their respective forum).
  544.  
  545. Chairmanship
  546.  
  547. It is profitable for everyone when you assign a leader or
  548. "Chairman" to a forum.  People can identify him/her with the
  549. forum topic and have a direction to ask questions and enter
  550. comments.  The Sysop benefits by not having to police every
  551. forum and allowing the Chairman to pack and move messages.
  552.  
  553. Chairmen have the power to read private mail, delete and
  554. undelete any message in their forum.  Chairmen also have the
  555. power to set the security level required to read/enter messages
  556. as well as changing the description line for the conference via
  557. the CH command.
  558.  
  559. Chairmen can also assign away their chairmanship.
  560.  
  561. There are several things that a chairman (as well as the Sysop)
  562. has control over.  They include how many messages should remain
  563. active at any given time, how old messages can be before they
  564. are deleted, if people can enter private mail in this forum,
  565. what security levels can read or enter mail in this forum, and
  566. the description of the forum (displayed in the forum menu.)
  567.  
  568. Message Forum Security
  569.  
  570. Security is also defined by the CH command.  Version 0.36 and
  571. above have special security "groups".  The security level for
  572. each message forum can be set as always with a "security level
  573. >= X" where X is a security level set by the Sysop.  A new
  574. edition will allow up to four exact security level matches as
  575. well.  These are defined as "secuirty level = X" where X is a
  576. security level set by the Sysop.
  577.  
  578. For example, if a Sysop has defined security level 35 to be
  579. "Macintosh Users" and 40 to be "Amiga Users" and 50 to be "DOS
  580. Users" and wishes only "Macintosh Users" and "DOS Users" to
  581. access the "Windows GUI" forum, security can be set as follows
  582. (via the SE command, set security level).
  583.  
  584. Security Level >= 200   (All levels >= 200 have access)
  585. Security Level = 35     (Give Macintosh Users access)
  586. Security Level = 50     (Give DOS Users access)
  587.  
  588. Up to four specific "exact" secuirty levels may be defined.
  589. This method gives greater flexability than pervious "group"
  590. methods, as the entire BBS is not limited to a certain number of
  591. "groups".  Access, however, may only be given to a maximum of 4
  592. specific security levels and one greater than or equal range of
  593. security levels.
  594.  
  595. Also, in the case of FidoNet forums:  A user with security
  596. greater than or equal to the enter security for that forum may
  597. enter normal messages.  BUT, if that user attempts to enter or
  598. reply to a FidoNet message, their security level must exceed or
  599. be equal to that of the security level set tin the SE option for
  600. entering FidoNet messages.  That is to say, a FidoNet (not Echo)
  601. message can only be sent if the security of that user is
  602. authorized.
  603.  
  604. Every forum may have a initial screen displayed when you first
  605. join it.  This is useful in showcasing the forum for first time
  606. joiners, so they will get an idea of what the forum is about.
  607.  
  608. File Directories
  609.  
  610. File directories in TurBoard are used to catagorize files into
  611. different interest groups.  In reality all the files
  612. descriptions are stored in one file (this may prove to be a
  613. problem with large networks).  A separate file contains
  614. information on the "directories".
  615.  
  616. When a file belongs to a directory, it is specifying where it
  617. resides on the BBS system physically.  In addition it is giving
  618. a general description of what the file does/is.  Please do not
  619. manually move files, as TurBoard attempts to keep up with where
  620. that file is on the system.  If you move files around outside of
  621. TurBoard, the system will get confused and may not operate
  622. properly.
  623.  
  624. Adding and Maintaining File Directories
  625.  
  626. Adding a new file directory is easy.  Use the AF (Add File
  627. directory) command to specify a name for the directory, path on
  628. the disk drive, and description.  The name is of little
  629. importance, but you should note that the directory menu sorts
  630. the descriptions based on your directory name.
  631.  
  632. For example:
  633.  
  634. UPLOADS   Recent Uploaded Files (Always use UPLOADS with an S!)
  635. DOSGAMES  DOS Game Programs
  636. DOSGRAPH  DOS Graphics Programs
  637.  
  638. Will appear as:
  639.  
  640. 1] DOS Game Programs          2] DOS Graphics Programs
  641. 3] Recent Uploaded Files
  642.  
  643. This is useful when you want to group like directories together.
  644.  
  645. Another function you should be aware of is the FF command.  This
  646. command will scan all of your disk drive directories specified
  647. in the file descriptions for new files.  If one is found, it
  648. will prompt you for information about that file.
  649.  
  650. To list the files you currently have on-line, use the F command.
  651.  You will see the file directory menu, and at this point you may
  652. choose a number or type in a search keyword.  For example, you
  653. may type DOS and GAME to get files that match those keywords.
  654.  
  655. Adding Files to Your Directories
  656.  
  657. The easiest and best way to add files to your directories is to
  658. upload them while locally logged on.  For example:
  659.  
  660. First, you must have an upload (UPLOADS) directory, if you are
  661. not sure, read the section on uploads below before continuing in
  662. this section.
  663.  
  664. While you are locally logged on (either by ALT-L or the DOS
  665. command "turboard -l") use the U command (for upload file).  You
  666. will be prompted for a path and a filename.  Give TurBoard the
  667. path and filename of the file you wish to upload, and it will be
  668. added to the upload directory.
  669.  
  670. Once the file is added, display it with the N command.  Choose
  671. the number of the file you just uploaded, and then choose the
  672. option to move the file.  At this point, you may place the file
  673. in any directory you see fit.
  674.  
  675. To add a lot of files at once, copy the files (at the DOS
  676. prompt) into the physical directory you wish to add them to. 
  677. Log back into TurBoard and use the FF function.  Enter each
  678. description of the files.  Verify the files were added by using
  679. the f command and listing your directory.
  680.  
  681. Once a file is added, ALWAYS move it with the TurBoard move
  682. command, otherwise the File Listing will not have correct file
  683. location information.
  684.  
  685. UPLOADS and how they work
  686.  
  687. There is no rule governing how the file directories should
  688. appear except one:  In order to receive uploaded files, the
  689. Sysop needs to create an UPLOADS (with an S!) file directory. 
  690. This directory says that all uploaded files will be placed in
  691. this directory, otherwise they go to the root file directory.
  692.  
  693. When a file is uploaded (or placed in the upload directory and
  694. FF function used), you will be asked for a one line description
  695. of the file.  Following that, you will enter the full screen
  696. editor where you will be tempted to write a paragraph or two on
  697. the file.  This is purely optional, you can abort the edit and
  698. continue on.
  699.  
  700. There is a text file that is displayed whenever the U command is
  701. issued.  It is called UPLOADS.TXT.  If you have used the default
  702. subdirectories, use the command:
  703.  
  704. > edit text\uploads.txt
  705.  
  706. You can include TurBoard colors and text to be displayed,
  707. formatting is automatic.
  708.  
  709. There are additional special directory information files that
  710. you may want to create.  These files are keyed to the search
  711. keywords or directory names and have the extension .FXT.  For
  712. example, you can create a UPLOADS.FXT file in the TEXT directory
  713. to display whenever someone lists your most recent uploads.  If
  714. someone enters the command "F ALL" TurBoard will check to see if
  715. there is an ALL.FXT file in your TEXT directory, and if so,
  716. display it along with the complete file listing.  Other examples
  717. are "F GAMES" for GAMES.FXT or "F 3" for the directory name for
  718. #3 with an .FXT extension.
  719.  
  720. Doors
  721.  
  722. A "doorway" or "door" (once called a "window") is actually an
  723. external program that the bulletin board software passes
  724. complete control to.  This is generally a game (likeTradeWars or
  725. Solar Realms) or some useful information, like a BBS list or
  726. Bible Trivia Game.  It is TurBoards responsibility to initialize
  727. any information files that the door requires.
  728.  
  729. TurBoard uses the AD (add door) and CD (change door) command to
  730. maintain the door system.  Doors can be entered with the DO
  731. command.  In order for doors (and up/downloads) to work
  732. correctly, TurBoard must be started with the TB.BAT file,
  733. otherwise, when a user enters a door, it will drop to DOS and
  734. processing will stop.
  735.  
  736. Doors are by far one of the hardest things to install, simply
  737. because there is no specified standard by which they work.  Each
  738. one is different and therefore a challenge, I'm afraid to say. 
  739. There are several questions you will be asked that TurBoard uses
  740. to try to talk with a door.  These are:
  741.  
  742. Name - The 1-8 character name you choose to give your door.
  743.  
  744. Description - A 60 Character description of the door contents.
  745.  
  746. Path - The physical path of the door (this may be specified from
  747. the root TurBoard path, i.e. DOOR/SOLAR is the name of
  748. C:\TURBOARD\DOOR\SOLAR, if C:\TURBOARD is your root TurBoard
  749. path;the path you are in when you start TurBoard.)
  750.  
  751. Command - the DOS command to start the DOOR, usually a BAT file.
  752.  This BAT file should exist in the directory you specified in
  753. the PATH option.
  754.  
  755. FileType:  Currently, only one file type is supported.  It is
  756. TurBoard type 1.  Specifing type 1 tells TurBoard to put a
  757. DORINFO1.DEF file in the directory specified in the PATH
  758. parameter.  Please set up your door to look for DORINFO1.DEF
  759. there.
  760.  
  761. ANSI - If this option is true, the user must have ANSI graphics
  762. turned on before entering this door.  This helps cut down on
  763. ASCII users starting something they cannot finish.
  764.  
  765. NAPLPS - If this option is true, the user must have NAPLPS
  766. graphics turned on before entering this door.  This helps cut
  767. down on ASNI below users starting a NAPLPS graphics door.
  768.  
  769. Security - The minimum required security level of the user
  770. starting the door.
  771.  
  772. Delete this entry - option to delete this door record.
  773.  
  774. The YAK Subsystem
  775.  
  776. YAK really doesn't stand for anything other than "to talk,
  777. probably more than one should."  In any case, the YAK subsystem
  778. in TurBoard is where specialized information such as logon news,
  779. mail notifications and even the main menu come from.
  780.  
  781. To start the YAK subsystem, type "YAK" at the TurBoard prompt.
  782.  
  783. To use YAK requires that you understand what you want to happen.
  784.  For instance, if the first thing the user sees is the logon
  785. news, the NEWS information should come first.
  786.  
  787. These are the current checks, and YAK supports 4 different
  788. checks at a time.  These are the criteria that must be met
  789. before a message (text file) is sent to the user.
  790.  
  791. For example, the main menu should be the last item in your YAK
  792. list.  It should use only 1 check value (number 9).  
  793.  
  794. In case 5, the X value is an internal TurBoard (DOS, actually)
  795. format.  To use the integer for exactly the point in time you
  796. are entering the information, use the NOW keyword.  This will
  797. insert the DOS date/time stamp for that point in time.
  798.  
  799. Whenever TurBoard is finished processing, it checks the YAK
  800. List, it goes through each item in the list to see if that item
  801. meets all the criteria.  If so, TurBoard displays the file
  802. associated with that information and sets the different yes, no
  803. and blank response information.
  804.  
  805. Perhaps you want the BBS to ask a user if they want to read
  806. their mail now, if they have mail waiting.  This can be done
  807. with the YAK subsystem as follows:
  808.  
  809. Make a new YAK entry:
  810.  
  811. Display file:  MAILNOW
  812.  
  813. Check1: 1
  814. Checkval1: 0
  815. ... [leave the rest of the checks as default]
  816. Yes Responce: P  (the command to read your personal mail)
  817. No Responce:
  818. Blank Responce:
  819.  
  820. Using your TurBoard editor or the YAK option to edit the
  821. MAILNOW.YAK file.  Ex:  EDIT YAK\MAILNOW.YAK.  It should read:
  822.  
  823. You have new mail waiting, do you wish to read it now?
  824.  
  825. User Commands
  826.  
  827. Following commands can be entered at the > prompt.  Most of the
  828. two letter commands require extended access.
  829.  
  830. ? - Help with the currently executing operation.
  831. A - Art Gallery - Shows various ANSI and NAPLPS
  832. displays.
  833. B - Bulletins
  834. C - Classified Ads - Enter/ read/ scan classified ads.
  835. D - Download File - Receive a file from TurBoard into your
  836. system.
  837. DO - DOOR menu - Run an external program from TurBoard.
  838. E - Enter Message - Send a message to another user or to the
  839. general public.
  840. F - File directory List - List files available for download.
  841. G - Good-bye (log off) - Leave this TurBoard system.
  842. H - Emulation Toggle - Change to ASCII, ANSI or NAPLPS mode.
  843. I - Inquiry (history) - Show caller history.
  844. J - Join Mail Forum - Join a message forum (usually by subject.)
  845. K - Delete message - Remove the message you just read.
  846. L - BBS List - List BBS systems on-line.
  847. N - New Files - List new files since you have last logged on.
  848. O - Operator page - Page the operator for a "chat" session.
  849. P - Personal Mail - Read mail that has been flagged for you.
  850. Q - Display the Main Menu - Go back to the main menu.
  851. R - Read Mail - Read messages in the current forum.
  852. S - Scan Current Forum - Scan messages in the current forum.
  853. T - User List - List the users who are active on this system.
  854. TIME - Displays day, time and time remaining.
  855. U - Uploads - Upload files to this TurBoard system.
  856. V - Version - See the version of TurBoard this system is using.
  857. W - Who's on - See the other people signed onto this TurBoard
  858. X - eXpert toggle - Put your session in Xpert mode.
  859. Y - Your information - Review and change your user account
  860. information.
  861. CH - Chairman Utilities - Change forum defaults information.
  862. Chairman or Sysop access.  Allows the assigning (or assigning
  863. away) of chairmanship, setting of certain forum options.
  864. AM - Add Mail Forum - Starts a new message forum and adds all
  865. the associated information.
  866. DM - Delete Mail Forum - Deletes a message forum (data files
  867. remain intact, you must physically, ie via DOS, remove the files
  868. in that subdirectory).
  869. MM - Move message - Moves a message from the current forum to
  870. another specified forum.
  871. PM - Pack Message Forum - Deletes messages that have been
  872. "deleted" and private mail that has been read.  Removes data
  873. files and header records.
  874. AF - Add new file directory - Will add the file forum and
  875. include it on the forum choice list.
  876. DF - Delete file directory - Remove an empty file directory from
  877. the directory menu.
  878. FF - Fix File Information - Will search all the file storage
  879. directories for new files not included in the list and add them
  880. (you must type in the descriptions).
  881. YAK - YAK subsystem
  882. TYPE - print specified text file
  883. EDIT - edit specified text file
  884. COPY - copy a file from one DOS location to another.
  885. DIR - Give a directory of the specified DOS directory.
  886. AD - Add new DOOR - This command will add a new door (be sure
  887. you know what you're doing!)
  888. CD - Change existing DOOR - After a door has been added, you can
  889. change the setup with this command.
  890.  
  891. Classifieds
  892.  
  893. The Classified feature of TurBoard is not a standard bulletin
  894. board feature.  It's function is to provide a place for the
  895. buying and selling of goods through the public (not retail).
  896.  
  897. Most bulletin boards will include a "For Sale" forum to
  898. accomplish this function.  I found that this was difficult for
  899. people to use because it didn't organize the information in a
  900. way people could easily get at it.  They are required to scan
  901. the subject of every message and pick the one's they are
  902. interested in.
  903.  
  904. This will work okay so long as there are only a few ads to scan
  905. though.  So I thought to myself, "What do people normally use to
  906. buy and sell items?  Classified ads!"  So I decided to implement
  907. an "electronic" version of the classified ads.
  908.  
  909. I have included a rather detailed category file (in TBADS.ZIP on
  910. PC Chattanooga 615/756-7810) that is based on the Atlanta
  911. Journal/Constitution.  Of course, you can create your own, but
  912. it's tedious!
  913.  
  914. You may add new classified categories with the C command. 
  915. Simply choose the "Add new category" option.  Other than this,
  916. the system is completely self maintaining.
  917.  
  918. BBS List
  919.  
  920. This is a fairly standard BBS feature.  There are some doors
  921. that perform the same function available.  The advantage to the
  922. TurBoard BBS List command (L at the main prompt) is the ability
  923. to comment and review each BBS entry individually.
  924.  
  925. The BBS List also does not require any maintenance on the
  926. Sysop's part.
  927.  
  928. Once you choose the L command, you have several options.  A
  929. complete BBS list, a local BBS list, add a new BBS entry or
  930. create the BBS text file.
  931.  
  932. The difference between the complete and local BBS list is the
  933. "Is this BBS a local call?" flag.  Only those that answered yes
  934. are displayed in the local BBS list, thereby eliminating toll
  935. call BBS's.
  936.  
  937. To add a new BBS entry, you can accomplish that one of two ways.
  938.  You may use the ADD command while displaying the entire BBS
  939. list, or you may simply choose option 3.  If you use the ADD
  940. function, you will see the BBS inserted in the list as you are
  941. listing it, so you can ensure that it was indeed added.
  942.  
  943. Option 4, create the BBS text file, is an option you can use to
  944. publish your BBS list.  It will create a text file with two
  945. sections, a short BBS list and a detailed BBS list.  Before the
  946. first section the file "BBSLIST.TXT" will also be included from
  947. the text file path.
  948.  
  949. If you wish to edit this file, and you have used the default
  950. path names, use the command:
  951.  
  952. > edit text\bbslist.txt
  953.  
  954. After you have edited the file, save your changes and it will be
  955. included in your next BBS text file creation.  
  956.  
  957. On-Line Books
  958.  
  959. Some BBS programs refer to features similar to this one as
  960. "continuous story" or "book writer".  I had planned to include
  961. an option for on-line databases, but due to the request of one
  962. of the users of PC Chattanooga, I added support for a
  963. "continuous story" as the initial implementation.
  964.  
  965. The idea here is to have entertaining, technical or whatever
  966. kind of information available for users to access on-line (with
  967. the option to download all or parts of the information).
  968.  
  969. In addition the users may add to the information as they feel
  970. nessessary.
  971.  
  972. Options are planned for keyword searching, downloading,
  973. uploading, etc. of the books.
  974.  
  975. To enter the book option, type the command:  BO
  976.  
  977. From this point you will be able to enter/delete/add to books
  978. and chapters of books.  Each book may have an "Author"
  979. associated with it.  This is sort of like the Chairmen in the
  980. message areas.  Editors can control, add and delete the chapters
  981. in their book.
  982.  
  983. Each book consists of multiple chapters.  Each chapter is either
  984. "open" or "locked".  An open chapter allows users to append to
  985. the end of it.  For example, they may continue the current story
  986. or add information to a technical document.
  987.  
  988. There may become a time when the Author decides that a chapter
  989. is complete, and wishes to stop the extensions on it.  The
  990. chapter may be locked via the edit chapter option (after a
  991. chapter is read).  This will disallow further additions to the
  992. chapter.
  993.  
  994. Art Gallery
  995.  
  996. Version 0.40 and above are equipped with an Art Gallery.  This
  997. is a method for displaying ANSI ASCII and NAPLPS frames as works
  998. of art or to demonstrate a terminal emulation like NAPLPS.
  999.  
  1000. In order to add a work of art, use the AA (for Add Art) command.
  1001.  To edit the information used to display a work of art, use the
  1002. EA (Edit Art) command.  And to display works of art use the A
  1003. (Art Gallery) command.
  1004.  
  1005. There is an added command called DEMO.  This will rotate between
  1006. works of art with a specified period of time.  The rotation will
  1007. include all the works of art regardless of current terminal
  1008. emulation.
  1009.  
  1010. Keyboard Commands
  1011.  
  1012. Alt-S  Snoop Mode Toggle
  1013.  
  1014. Snoop mode should be OFF anytime you don't wish to monitor the
  1015. BBS caller.  Screen writes can slow the output data stream to
  1016. the caller, so to increase your BBS's performance, turn snoop
  1017. mode OFF at all times.
  1018.  
  1019. Alt-T  Chat mode on/ Terminal Mode
  1020.  
  1021. To answer a sysop page, use the Alt-T command.  Also, from the
  1022. call waiting screen, Alt-T will put you in a full
  1023. ASCII/ANSI/NAPLPS terminal emulation.
  1024.  
  1025. Alt-O  Operator available Toggle
  1026.  
  1027. This toggle the ability of your users to page you.  Turning
  1028. sysop page on will allow the BBS users to call you for a chat
  1029. session while they are on-line.
  1030.  
  1031. Alt-X  Exit
  1032.  
  1033. Exit the current operation.  If at call waiting screen, exits
  1034. TurBoard.
  1035.  
  1036. Alt-I  Information
  1037.  
  1038. Gives information on registering the TurBoard BBS package.
  1039.  
  1040. Alt-L  Local log on
  1041.  
  1042. Used from the call waiting screen to log on the BBS locally. 
  1043. Name and password is required for security.
  1044.  
  1045. Colors?
  1046.  
  1047. Turboard uses single ASCII characters to indicate different
  1048. colors, you can take advantage of this in the editor and input
  1049. prompts.
  1050.  
  1051. In NAPLPS mode, TurBoard assigns the following colors to the
  1052. internal TurBoard format for cross-compatibility.
  1053.  
  1054. To enter these numbers in manually on a line (the file directory
  1055. description prompt, for example), use the alt key.  While
  1056. holding down the ALT key, type the 3 digit number on the numeric
  1057. keypad and then release the ALT key.  At that point the color of
  1058. the text you type will change.  TurBoard treats this character
  1059. as a full character, so if you make a mistake, be sure to
  1060. backspace as far as you can go before trying again.
  1061.  
  1062. Full Screen Editor
  1063.  
  1064. The full screen editor work with WordStar commands.  If you are
  1065. logging on remotely be sure to use doorway mode to get maximum
  1066. function from your keyboard.  F1 or Ctrl-H for additional help.
  1067.  
  1068. Colors are stored in TurBoard format (see colors above) but in
  1069. the full screen editor do not take up a character of space.
  1070.  
  1071. Line Editor
  1072.  
  1073. The line editor in TurBoard works as most BBS line editors. 
  1074. Wordwrapping is automatic, and when you are finished editing,
  1075. hit return on a blank line.
  1076.  
  1077. You will be prompted to Continue, Abort, Quote or Save.  If you
  1078. are replying to a message, you may quote by choosing line number
  1079. in the message you want to quote.
  1080.  
  1081. Colors are not supported in the Line editor.  (Quoting will
  1082. still have the highlighted ">".)
  1083.  
  1084. Command Line Parameters
  1085.  
  1086. There are certain command line parameters that will allow
  1087. TurBoard to operate in a networking/FidoNet environment.
  1088.  
  1089. These are:
  1090.  
  1091. #  -  Node number 
  1092. (defaults to 1)  Ex: turboard 2
  1093. -l -  Local Switch
  1094.  
  1095. This switch will bypass the call waiting screen and go directly
  1096. to local log on.  For example, if you are in a networking
  1097. environment, you can use this switch at program startup, so that
  1098. the network node will begin at logon.
  1099.  
  1100. Ex: turboard -l
  1101.  
  1102. -fd -  Front Door Active
  1103.  
  1104. This switch is used when using a front door processor, such as
  1105. BinkleyTerm or Front Door.  It will cause TurBoard to check for
  1106. a carrier detect, as well as to fall back to DOS after logoff. 
  1107. (The call waiting screen in used in this mode.)
  1108.  
  1109. Ex: turboard -fd
  1110.  
  1111. -p##### - Incoming port rate
  1112.  
  1113. This switch is generally used with the -fd switch so the front
  1114. door can pass the port rate to TurBoard.  The modem to remote
  1115. CONNECT rate my not be the same as the Modem to DTE PORT rate. 
  1116. If this parameter is specified, TurBoard will communicate to the
  1117. modem at this rate.
  1118.  
  1119. -b##### -  Incoming call baud rate
  1120.  
  1121. This switch is generally used with the -f switch so the front
  1122. door can pass the baud rate to TurBoard.  An example of the
  1123. Batch file that might be used is:
  1124.  
  1125. (%3 contains the baud rate parameter)
  1126.  
  1127. turboard -f -b%3
  1128.  
  1129. -cbios - Use BIOS for NAPLPS writes.
  1130.  
  1131. If you experience "snow" or unexpected results on you NAPLPS
  1132. displays, you may want to try this switch, it will tell TurBoard
  1133. not to use direct EGA and VGA hardware writes and to go through
  1134. the BIOS instead.  On the downside, turning this switch on may
  1135. cause you to lose characters when in TurBoard Terminal Mode.
  1136.  
  1137. -t### - Max Time allowed
  1138.  
  1139. This parameter can be used to limit a BBS visit's time limit (in
  1140. the case of an upcoming event).  This parameter is usually
  1141. passed from some kind of front door processor.
  1142.  
  1143. %4 contains the time limit.
  1144.  
  1145. Ex:  turboard -fd -b%3 -t%4
  1146.  
  1147. Modem Configuration Strings
  1148.  
  1149. The following strings may be used to help configure TurBoard.
  1150. Use the one that most closely matches your computer.  (You may
  1151. refer to your modem manual for additional information.)
  1152.  
  1153. Modem Init String
  1154.  
  1155. Hayes 1200:  ATS0=0M0S2=1X1H0E0
  1156. Hayes 2400:  ATS0=0M0S2=1X1H0E0
  1157. Hayes 9600 V.42:  AT&F&K0&C1&D2S0=0S2=255M0E0H0
  1158. Hayes ULTRA:  AT&F&K0&C1&D2S0=0S2=255M0E0H0W1
  1159. USR Dual Standard:  AT&F&B1&C1&D2S0=0S2=255M0E0&WH0
  1160. (USR HST, I haven't tested...)
  1161.  
  1162. Terminal Init String
  1163.  
  1164. Hayes 1200:  ATE1M1
  1165. Hayes 2400:  ATE1M1
  1166. Hayes ULTRA:  ATE1M1L1
  1167. USR Dual Standard:  ATE1M1L1
  1168.  
  1169. Use the standard response codes (check your manual for exact
  1170. spelling).
  1171.  
  1172. Ex:  RING, CONNECT, RINGING, NO CARRIER, BUSY, NO DIAL TONE
  1173.  
  1174. If you have any configuration strings that I have not mentioned
  1175. here, be sure to leave a message on the support BBS!
  1176.  
  1177. Common Questions on Modem Configuration:
  1178.  
  1179. When I start my system, it gets hung in a loop trying to log
  1180. itselfon and off.  What's wrong?
  1181.  
  1182. The problem lies in the modem configuration.  TurBoard will jump
  1183. to the terminal emulation prompt if it thinks there is someone
  1184. on-line.  Most modems can configure the Carrier Detect pin (CD)
  1185. to follow actual carrier detect or not either by switch settings
  1186. or an internal command (USR uses &C1.)
  1187.  
  1188. You want to set your modem up so that Carrier Detect follows
  1189. actual carrier detect.  (If you do not have switch settings, add
  1190. the command to the end of your modem initialization string via
  1191. the SE command.)
  1192.  
  1193. When someone tries to log off the system, they just get put back
  1194. at the start-up prompt again, or the BBS just sits there. 
  1195. What's wrong?
  1196.  
  1197. A high to low signal in the (Data Terminal Ready) DTR needs to
  1198. be set to cause the modem to hang up the line.  Most modems use
  1199. a switch setting or AT command to control this feature.  (USR
  1200. uses &D2.)  If you do not have switch settings to control this
  1201. feature, add the command on the end of your modem initialization
  1202. string via the SE command.
  1203.  
  1204. FidoNet !
  1205.  
  1206. FidoNet is a worldwide network of bulletin board systems which
  1207. communicate to each other through message "packets"  TurBoard
  1208. v0.33 and above will interface with any other FidoNet or
  1209. compatible system through a front door.  A front door is a
  1210. program which answers the incoming call, decides if the caller
  1211. is another FidoNet system or an actual user, and either receives
  1212. the FidoNet package or transfers control to the BBS system
  1213. (TurBoard).
  1214.  
  1215. TurBoard v0.33 includes all the files nessessary to configure
  1216. FidoNet with a front door processor.  This includes the
  1217. "scanning/tossing" of incoming and outgoing messages.  This is
  1218. performed by the TBFIDO.EXE program.  This program will convert
  1219. the incoming FidoNet messages to TurBoard format and put them in
  1220. their proper message forums.  It will also export messages
  1221. entered in the TurBoard forums and put them into FidoNet
  1222. "packets".
  1223.  
  1224. Configuration of TurBoard with FidoNet
  1225.  
  1226. The hardest part about interfacing with another external program
  1227. is configuration.  TurBoard has been extensively tested with
  1228. BinkleyTerm, and I would suggest using that software.  Included
  1229. is a text file called BINKLEY.CFG.  This file contains an
  1230. example BinkleyTerm configuration file.  There is also a .BAT
  1231. file included (TBFN.BAT) that should be used to initialize
  1232. TurBoard when running FidoNet.
  1233.  
  1234. It is your responsibility to ensure that the nodelists and other
  1235. data that BinkleyTerm requires is configured correctly.
  1236.  
  1237. When you are running FidoNet, start the TurBoard system with
  1238. TBFN.BAT rather than TB.BAT, this will run the message packer
  1239. and automatically start BinkleyTerm.  I would suggest
  1240. configuring BinkleyTerm to match the ErrorLevel operations used
  1241. in TBFN.BAT.
  1242.  
  1243. Setting up FidoNet for the First Time
  1244.  
  1245. Actually, TurBoard is about ready to receive FidoNet message
  1246. strait out of the package.  Most of your time will be spent
  1247. setting up your front door processor (which can be trick if you
  1248. are not programmer inclined.)
  1249.  
  1250. To set up TurBoard for FidoNet, you will need to specify your
  1251. address in the SE menu.  You will also need to set up one of
  1252. your message forums as the primary FidoNet forum.
  1253.  
  1254. To setup the FidoNet forum (which can be any forum other than an
  1255. echoed forum), join the forum you wish to use.  (If you do not
  1256. have any forums defined yet, use the AM command first and then
  1257. join that forum.  But remember, the first forum you create will
  1258. be your master message forum, so you may want to name it
  1259. something like "PRIMARY" and then add a new forum for FidoNet,
  1260. which you may want to name "FIDONET".)
  1261.  
  1262. Once you are in the forum you wish to use for FidoNet messages,
  1263. issue the CH command and choose the option for Mail Type (it
  1264. will currently say:  "Normal").  Change this setting to F for
  1265. FidoNet.  At this point you are ready to go.  Any messages
  1266. designated with an address in this forum will be placed in the
  1267. FIDOOUT directory for processing by the front door.  It is your
  1268. responsibility to ensure that the address on the message is
  1269. correct.
  1270.  
  1271. TBFIDO.EXE
  1272.  
  1273. This program serves three functions.  First, it scanning the
  1274. incoming FidoNet directory and converts that information into
  1275. useable information by TurBoard.  Secondly, it checks the
  1276. outbound FidoNet packets, if it finds ones marked .ECHO, it
  1277. combines them into "ArcMail" which are nothing more than FidoNet
  1278. compressed packets with the ARC.EXE utility.
  1279.  
  1280. Thirdly, if the -p command line parameter is specified, the
  1281. program will scan and pack all of the active TurBoard message
  1282. forums.  This is complete and automatic.  The settings for the
  1283. compression are set with the CH command in the TurBoard system
  1284. itself.
  1285.  
  1286. FidoNet COST and TurBoard
  1287.  
  1288. Cost of messaging is very important to most FidoNet sysops.
  1289. Currently, TurBoard does not keep track of how much a message to
  1290. a certain system will cost, or even if the target system exists.
  1291.  For this reason, it is important that you configure your front
  1292. door processor (most likely, BinkleyTerm) when it can and cannot
  1293. send messages to different systems.  This is performed with
  1294. theBINKLEY.EVT file.  Here you can specify the cost of a message
  1295. that is allowed to be mailed.  (BinkleyTerm will check the
  1296. Nodelist for an entry and figure the cost from that list.)
  1297.  
  1298. EchoMail
  1299.  
  1300. TurBoard can handle echomail.  To configure where outgoing (and
  1301. incoming) messages are going, as well as the name of the
  1302. EchoMail area, use the CH command for your particular forum.
  1303.  
  1304. For example:
  1305.  
  1306. Once I have set up my system for FidoNet, I perform the
  1307. following:
  1308.  
  1309. Say I wanted to set up an EchoMail forum with PC Chattanooga in
  1310. Chattanooga, TN.  And the name of this EchoMail "AREA:" is
  1311. TURBOARD.  (This would be an answer and question echo about the
  1312. TurBoard BBS software package.)
  1313.  
  1314. First, I would create a new message Forum.  To do this I would
  1315. issue a AM command, choose a name for the forum (say "SUPPORT")
  1316. and enter a brief description.  Okay, now I want to join that
  1317. forum with the J SUPPORT command.
  1318.  
  1319. Once I have the SUPPORT forum as the active forum, I issue the
  1320. CH command to bring up the chairman utilities.  I choose the
  1321. option named "Mail type" (it currently says "Normal"), and then
  1322. choose E for FidoNet Echo.
  1323.  
  1324. Now, I choose the option to give the system the name of the echo
  1325. area (it will say: SUPPORT).  I want to change this to
  1326. "TURBOARD" since that is the name that FidoNet calls it (so
  1327. TBFIDO.EXE will know where to put those messages).  I also want
  1328. to set up the address of the other echomail members I am
  1329. responsible for sending and getting this echo from.
  1330.  
  1331. I choose the last option and add the address:
  1332.  
  1333.   Zone: 1
  1334.   Net: 362
  1335.   Node: 614
  1336.   Point: 0
  1337.  
  1338. I do this because this is the address of PC Chattanooga, and I
  1339. want to get all the messages from that BBS system as well as
  1340. address my new messages to it.
  1341.  
  1342. Once I've done this, all I need to do is inform PC Chattanooga
  1343. that I'm ready for the echo to be sent to me!  The same
  1344. procedure can be followed for ANY FidoNet echo.
  1345.  
  1346. Customizing Your Displayed Screens
  1347.  
  1348. A fairly recent addition to TurBoard is the support to
  1349. completely customize your File Directory screen as well as the
  1350. Forum Directory screen.  (I'm sure not everyone likes the way I
  1351. like to display theinformation!)
  1352.  
  1353. Here are the files you can alter, their format and their
  1354. function:
  1355.  
  1356. (All of these files should be in your "TEXT" TurBoard
  1357. subdirectory.  Also, none of these files have extensions [that
  1358. stuff after the .])
  1359.  
  1360. WELCOMEN, WELCOMEG and WELCOME  -  This is the initial logon
  1361. screen that is displayed just after the "Do you want to use ANSI
  1362. terminal emulation?  " question.  WELCOMEG is the ANSI version
  1363. of this file which should be edited with an ANSI editor (I
  1364. suggest THEDRAW).  WELCOME can be edited with the internal
  1365. turboard editor, and I suggest doing this if you don't want to
  1366. mess with the different ANSI codes (at least until a time when
  1367. you want to dive into it.)
  1368.  
  1369. WELCOMEN is a new edition, this is the NAPLPS welcome screen.
  1370. You will need an editor to create the file (SHARENAP.ZIP), but
  1371. once you have created the file, simply rename it to WELCOMEN and
  1372. copy it in the TEXT directory, this is you 'NAPLPS log on screen.
  1373.  
  1374. LOGOFFN, LOGOFFG and LOGOFF  -  These are the logoff screens
  1375. that your system will display when the user issues the G
  1376. command, just before they are disconnected.  The naming
  1377. convention is the same used with WELCOME.
  1378.  
  1379. To edit the WELCOME file (and get ANSI colors with out going to
  1380. the WELCOMEG file) use the internal TurBoard command EDIT.  For
  1381. example:
  1382.  
  1383. > edit text\welcome.     [you need to add the period so turboard
  1384. will know you are specifying a file]
  1385.  
  1386. NEWUSERN, NEWUSERG and NEWUSER  -  This is the information that
  1387. TurBoard displays when a user logs on for the first time.  Just
  1388. before the normal questions are asked to complete the on-line
  1389. information, the user is asked, "Do you agree with the above
  1390. conditions?  ".  This file will outline those conditions you
  1391. want to place.  This would also be a good place for a legal
  1392. disclaimer, which I highly suggest.
  1393.  
  1394. As before, use an ANSI editor (like TheDraw) to edit the
  1395. NEWUSERG file and you may use the internal TurBoard editor for
  1396. the NEWUSER file (ex: > edit text\newuser.)
  1397.  
  1398. DIRN, DIRG and DIR  -  These two files are completely optional.
  1399. In fact they are not included in the TurBoard distribution ZIP.
  1400. These were included so that you may add your own personality to
  1401. your File Directory listing.  When one of these files is placed
  1402. in the TEXT subdirectory, it overrides TurBoards internal File
  1403. Directory screen.
  1404.  
  1405. There are a couple of quirks, and I'll outline them now.  The
  1406. Sysop never sees the finished product of DIRG and DIR.  This is
  1407. because he needs to see what is really out there (things
  1408. change).  If youwish to see what these files look like
  1409. displayed, use the TYPE command.  
  1410.  
  1411. Ex: > type text\dirg.  [this will display the DIRG file as your
  1412. users would see it.]
  1413.  
  1414. Now, as before, the DIRG is reserved for ANSI codes hard coded
  1415. into the file, where the DIR file can be edited by the TurBoard
  1416. editor (see examples above).  BUT REMEMBER, if you wish to do
  1417. this, it is your responsibility to keep the DIRG and DIR file
  1418. correct and up to date.  If your system is like mine, your
  1419. directories will come and go and the numbering will change all
  1420. the time.  You need to reflect those changes in the DIRG and DIR
  1421. file.  This is why the Sysop will always see the normal TurBoard
  1422. listings.
  1423.  
  1424. (A quick side note:  I find it useful to create a dummy user
  1425. name that I log onto with to see what the system looks like to
  1426. the end user, I find it very helpful.  Just pick a name and log
  1427. on, you may even want to enter a message to yourself.)
  1428.  
  1429. FORUMN, FORUMG and FORUM  -  These files are along the same
  1430. lines as DIR and DIRG.  The sysop will never see them in their
  1431. used form, rather, he must use the TYPE command to see it.  As
  1432. before, FORUMG is the ANSI version.  If you want to keep
  1433. everything in the system, use the TurBoard editor to create/edit
  1434. the file FORUM, and here you may add colors, if you choose to.
  1435.  
  1436. Ex: > edit text\forum.
  1437.  
  1438. Again, it is the SYSOPS responsibility to keep these files
  1439. updated if he plans to use it.  TurBoard normally keeps the
  1440. menus updated, but does not update these files.
  1441.  
  1442. NAPLPS Color Graphics
  1443.  
  1444. If you have ever signed on prodogy, you have seen NAPLPS at
  1445. work.  The idea is to provide exciting color graphics to the age
  1446. old BBS technology.  Here is a brief description of what we are
  1447. talking about:
  1448.  
  1449. The North American Presentation-Level Protocol Syntax  (NAPLPS)
  1450. standard defines a text and graphics transmission interface with
  1451. display or recording devices with sufficient local intelligence
  1452. and memory to process the NAPLPS data stream.
  1453.  
  1454. In many respects, NAPLPS has reversed the normal progression
  1455. from functinal description to data format or language building. 
  1456. Instead, NAPLPS starts with the code extension technique
  1457. specified by ISO 2022-1982, ANSI X.41-1974, and CSA
  1458. Z243.35-1976, and fits a versatile picture-definition standard
  1459. into the constraints of the 32 character C sets and 94-character
  1460. or 96-character G sets established by those standards.
  1461.  
  1462. A major advantage of the code-extension technique is, of
  1463. course,that large amounts of information can be transmitted over
  1464. narrow-bandwidth transmission lines, provided the receiving
  1465. device is capable of expanding on the information.
  1466.  
  1467. In case you didn't understand the above, don't worry!  All you
  1468. reall need to understand is that NAPLPS is a way to transmitting
  1469. compressed color graphics pictures that are hardware
  1470. independent.  To create these images, you will need a NAPLPS
  1471. editor (there is a shareware one on PC Chattanooga called
  1472. SHARENAP.ZIP).
  1473.  
  1474. Another limitation is that the caller has to have a terminal
  1475. emulation program capable of decoding the NAPLPS codes.  (One
  1476. shareware program is NAPCOM.ZIP.)  Right now, there are not many
  1477. NAPLPS terminal emulation programs, but depending on the success
  1478. of TurBoard and other NAPLPS programs, this may soon change.
  1479.  
  1480. DAILY.BAT (The Daily Batch Event)
  1481.  
  1482. Many game doors require that you run a maintainance utility once
  1483. per day.  DAILY.BAT is TurBoards way of accomplishing this. 
  1484. After midnight, at the first idle moment, TurBoard executes this
  1485. .BAT file.  It is the Sysop's responsibility to include the
  1486. commands to run their particular application.
  1487.  
  1488. DAILY.BAT comes pre-configured to automatically pack all the
  1489. message forums with the TBFIDO.EXE program.  (Using the -P pack
  1490. mail switch.)  This takes responsibility away from the Sysop to
  1491. maintain the message forums.  You may also with to run other
  1492. programs such as a bulletin generator.
  1493.  
  1494. Nothing besides the file itself is required to run DAILY.BAT.
  1495. (TurBoard must have been started with TB.BAT or TBFN.BAT).
  1496.  
  1497. TurBoard Terminal Emulation
  1498.  
  1499. TurBoard has a built in NAPLPS terminal emulation mode, so that
  1500. busy Sysop's don't have to take their board down to call another
  1501. BBS system.  From the call waiting screen, type Alt-T, this will
  1502. start TurBoard's built-in terminal emulation mode.
  1503.  
  1504. There are several keys you should be aware of in TurBoard's
  1505. terminal emulation mode.  They are Alt-X to exit back to the
  1506. call waiting screen, Alt-C will put your terminal in ANSI mode
  1507. and clear the screen, PgUp will start a ZModem upload, PgDn will
  1508. begin a ZModem Download.
  1509.  
  1510. All the NAPLPS functions that are available in the normal
  1511. TurBoard BBS System are available in the terminal mode of
  1512. TurBoard.  Plans for terminal emulation mode is use of the
  1513. on-line BBS list for a dialing directory.  If you have any
  1514. suggestions for improving the Terminal Mode of TurBoard, please
  1515. let me know!
  1516.  
  1517. Registered TurBoard BBS's  (in order of registration)
  1518.  
  1519. The Haven (sysop Steve King) in Ringgold, GA (404/000-0000)
  1520. Steve owns Design Systems, a computer consulting firm
  1521. (404/861-1064) dealing in sales, service, rentals and leasing. 
  1522. He is a friend and I appreciate his early support.
  1523.  
  1524. Portable Panic (sysop David Gridley) in Rochester, NY
  1525. (916/254-7332)  David is the one who introduced me to NAPLPS. 
  1526. He is much more current in the BBS world than I am, and I am
  1527. grateful for all his help.  David runs a very current and
  1528. maintained system and is a constant supply of good ideas.  He
  1529. has helped me stay on track with TurBoard and is probably it's
  1530. most vocal supporter.  Thanks, David!
  1531.  
  1532. Poor Man (sysop Don Vickers) at WAFB, MO (816/563-5558)  Don is
  1533. about to move at the end of May, 1992, so you might check future
  1534. editions of this document for the correct phone number.
  1535.  
  1536. Mind's Eye (sysop Paul Erkkild) in Rochester, NY (716/427-7637)
  1537. Paul runs TurBoard under Windows 3.1.  It's a good thing
  1538. Microsoft added graphics support for windowed DOS sessions!
  1539.  
  1540. International Multimedia (sysop Ed Pimentel) in Atlanta, GA
  1541. (404/498-4254)  Ed has been a NAPLPS supporter for a long time. 
  1542. Hopefully, TurBoard will live up to his expectations!
  1543.  
  1544. Underground Monorail (sysop Brian McCord) in Dayton, TN
  1545. (615/365-7570)  Brian is primarily responsible for the DOors
  1546. option and has contributed a lot of good ideas to TurBoard.
  1547.  
  1548. (your name here!)
  1549.  
  1550. TurBoard Phone Support
  1551.  
  1552. Once you've registered TurBoard, you are entitled to free phone
  1553. support at 615/756-8220.  I hope you enjoy using TurBoard as
  1554. much as I've enjoyed programming it!  And remember, if you have
  1555. a suggestion or new idea, please give me a call or leave me a
  1556. message because I want to make TurBoard the best!
  1557.  
  1558. That's the end of the TurBoard documentation!  I hope it was
  1559. helpful, and please support this starving programmer by sharing
  1560. this program with your friends and businesses!
  1561.  
  1562. TurBoard v0.40
  1563.  
  1564. SKIP - Skip this forum
  1565. NEXT - Go to next forum
  1566. #### - read number
  1567. +    - read in forward mode
  1568. -    - read in reverse mode
  1569. K    - Kill previous message
  1570. FIX  - Alter previous message
  1571.  
  1572. 1     Mail>X      OK if user has mail waiting.
  1573. 2     Logons>X    OK if user has called more than X times
  1574. 3     Logons=X    OK if user has called exactly X times
  1575. 4     Logons<X    OK if user has called less than X times
  1576. 5     LastOn<X    OK if last date on < X value
  1577. 6     SecLvl>X    OK if security level > X
  1578. 7     SecLvl=X    OK if security level = X
  1579. 8     SecLvl<X    OK if security level < X
  1580. 9     expert mod  OK if expert mode is turned off
  1581. 10    ANSI        OK if ANSI mode is on
  1582. 11    NAPLPS      OK if NAPLPS mode is on
  1583. 12    NONE       OK if not in ANSI or NAPLPS mode (ASCII Mode)
  1584. 13    ANSI/ASCII  OK if either ANSI or ASCII mode
  1585. 14    Birthday    OK if today is user's birthday
  1586. 15   Random    OK if CheckValue is > random number between 1 and
  1587. 100.
  1588.  
  1589.  Black                128
  1590.   Blue                 129
  1591.   Cyan                131
  1592.   Red                  132
  1593.   Magneta           133
  1594.   Brown              134
  1595.   LightGray        135
  1596.   DarkGray         136
  1597.   LightBlue         137
  1598.   LightGreen       138
  1599.   LightCyan        139
  1600.   LightRed          140
  1601.   LightMagneta  141
  1602.   Yellow        142
  1603.   White          143
  1604.  
  1605.   Black            144
  1606.   Blue              145
  1607.   Green            146
  1608.   Cyan             147
  1609.   Red               148
  1610.   Magneta        149
  1611.   Brown           150
  1612.   LightGray      151
  1613.  Attributes Off       152
  1614.   Underscore          153
  1615.   Blink On             154
  1616.   Invisible              155
  1617.   Clear Screen         12
  1618.   Line Feed      <none>
  1619.   End of Parag.       13
  1620.